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Burroughs believes that the application package described in this 
manual is accurate and reliable, and much care has been taken in its 
preparation. However, no responsibility, financial or otherwise, can be 
accepted for any consequences arising out of the use of this material, 
including loss of profit, indirect, special, or consequential damages. 
There are no warranties which extend beyond the program specification. 


The Customer should exercise care to assure that use of the application 
package will be in full compliance with laws, rules and regulations of 
the jurisdictions with respect to which it is used. 


The information contained herein is subject to change. Revisions may 
be issued from time to time to advise of changes and/or additions. 


Any comments or suggestions regarding this publication should be forwarded to Documentation Department, 
Business Management and Scientific Systems, Burroughs Corporation, Burroughs Place, Detroit, Michigan 48232. 
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INTRODUCTION 


This manual provides an introduction to and an overview of Surroughs 

B 1800/8 17uU0 GEneralized Message COntrol System (GEMCOS). fhe primary 
purpose of this manual is to provide data processing managers with 
enough information about GEMCOS to determine its usefulness in their 
own environment. What GEMCOS can do and why GEMCOS provides these 
capabilities are describeds very little is said regarding how GEMCOS 
does these things. The use of technical terminology 1s minimal. A 
general data processing or data communications background would be 
heipful» but not necessary» to understand GEMCUS as described herein. 


Section 1 of this manual contains a discussion of the need for and the 
functions ot message control systems (MCSsS) tn onwmdine systems in Qgen- 
eral and in Burroughs B 1800/8 1700 Systems in particular. I[t is hoped 
that this section provides the technically uninitiated with a reason- 
able perspective on how the MCS fits into the total on-line environment 
and how it relates to other components» such as application programs» 
the data base management system» and the network controtter. 


Section 2 describes the general benefits of GEMCOS and the major 
capabilities of the two versions of GEMCOS. Sections 3 and 4 describe 
in greater uetail the capabilities of the two versions: The Basic 
Version (style identification numbers B1800 MCB and B1700 MCB)» and 
the Advanced Version (style identification numbers B1800 MCA and 

B1700 MCA). 


The technically ortented reader may learn more about GEMCOS and the 
B 1800/8 17.0 Systems onwline environment in general by referring to 
the following Burroughs manuals: 


a- B if00 Generalized Message Control System (GEMCOS) User's 
Manual» form 1093499. 


be. B if00 Systems System Software Operation Guides form 1068731. 


Ce B i700 Systems Network Definition Language (NDL) Reference 
Manual», form 1073715. 


de» 8B if00 Systems User Programming Language CUPL) Reference 
Manual» form 1067170. 


e- B if00 Systems COBOL Reference Manuals form 1057197. 


f. B 1700 Systems Report Program Generator (RPG) Reference 
Manual» form 1057189. 


g- B if700 Systems FORTRAN. Reference Manuals form 1081882. 
These manuais are Listed approximately in order of relative importance 


with respect to GEMCOS. Those which refer only to the 8 1700 systeam 
apply equatiy to the B 1800 System. 


SECTION 1 


MESSAGE CONTROL SYSTEMS 


ON-LINE COMPLEXITIES. 

As business data processing has evolved toward on-line processing in a 
multitask environment Cmultiple programs running concurrently)» pro- 
gramming couplexities have increased by an order of magnitude. They 
involve proulems such as: 


ae Preventing two or more programs from updating the same 
record stmultaneously. 


b. Preventing unauthorized access to programs and/or data 
baseS. 


Ce Encoding data properly for transmission to or from the 
network. 


d.- Maintaining orderly communication between the computer 
anu devices in the networks even when several devices 
share the same Line to cut communications costs. 


e- Ensuring that messages from the network and from programs 
running in the central System are properly routed to 
their destinations. 


fe. Auciting Cwriting to disk or tape) of messages and data 
base transactions. 


ge Recovery of running programs» data bases» and messages or 
transactions tn the event of a failure. 


he. Formatting data appropriately for each hardware device in 
the network. 


This list is not exhaustiver but suggests the kind of problems which 
must be considered in an on-line» multitask environment and which did 
not even exist in the single program batch systems of the past. 


BURROUGHS GirLINE SOFTWARE. © 

If application programmers had to address all these problems in their 
programs» the simplest application would become unbelievably complex. 
Fortunately» a better way has been found. Software modules speci fi- 
cally designed to relieve the application programmer of these burdens 
have evolvec. [These modules and their interrelationships are shown in 
figure i-l. 


Data base Management systems coordinate access to the data base and 
recover the data base after a failure. 


The network controller transmits and receives messages to and from the 
network. This function often involves code conversion and may involve 
message auditing. In Burroughs systems» the network controller program 
is generateg from a description of the network in Network Definition 
Language (NUL). 


The message control system (MCS) interfaces with the network controller 
and with the application programs. As shown in figure 1-2» the MCS 
exerts control over both the network environment and the program 
environment. HCS functions may include the following: 


ae Message routing. 

be. Access control. 

Ce AuUdit/message restoration. 
d. System management. 

ee Message formatting. 
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Figure 1-1. On-Line Software 
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Figure 1°72. The Role of the MCS 
The MCS and network controller together relieve the applications 
programmer of: 


ae Line control Ceege» connect/disconnect» polling and 
adaressing» timing» error detection and retransmission). 


be Line ouffer allocation and control. 
ce Recovery from abnormal conditions. 
de Terminal interfacing. 

e. Network control. 

f. Message routing. 


g- Access control. 


he. Message auditing. 
1. Message formatting. 


In shorts atl the application programmer must worry about is the 
requirements of his application and maintaining a simples standard 
interface with the MCS. 


CANDE» RJE» and GEMCOS are examples of MCSS available in the 
B 1800/8 1i/7u0 Systems. 


CANDE is a special-purpose MCS which facilitates on-line program 
development and testing. Using CANDE from a time-sharing terminals a 
programmer can enters» edit» compiler debuge and execute a program very 


conveniently. 


RJE (Remote Job Entry) is another special-purpose MCS designed to 
facilitate running batch jobs from remote locations. 


GEMCOS 1s an MCS which is meant to run in a transaction-oriented» 
on-line processing environment. Its features and capabilities are 
described in sections 2 thru 4. 


SECTION 2 


B 1800/B 1700 GEMCOS 


GENERAL BENEFITS- 


GEMCOS is a transactton-ortented MCS designed to provide a flexible 
user interface that does not compromise efficiency: 


ae It provides the data communications user with a viable 
interface between the network controller and the application 
programs which process transactions from on-line terminals. 
GEMCOS and the network controller work together to relieve 
application programs (Cand programmers) of the numerous compli- 
cated considerations inherent tn an on-line environament. The 
design of application programs is thus tndependent of the 
environment in which they operates a feature which protects 
a user's investment in these programs. 


be. As illustrated in figure 2-1» GEMCOS and DMS II can work 
toyether to insulate application programs from the complexi- 
tics of the network and the data base» respectively. Of 
courses either can operate independently of or without the 
other. 


ce GEMCOS conserves personnel time and effort because it is 
reiatively easy to instali and interface. 


GEMCOS is atiso a flexible MCS. It provides users of B 1800/8 1700 
Systems with a tool for tailoring network control to meet their spe- 
cific requirements. GEMCOS accommodates a broad range of throughput 
and processing requirements. GEMCOS is also an on-going mechanism for 
continuous network control in the dynamic environment of data commu- 
nications systems-e As applicationtoriented requirements cnange or 
new hardware opportunities arises the user employs GEMCOS to adapt to 
changes in: 


ae Central site hardware configuration. 

b. Central site software structure. 

ce Network configuratione including terminal changes. 
ds Application/data base design. 


GEMCOS VERSIONS» 

To accommodate the small user as well as larger» more complex in- 
Stallations,» GEMCOS is available in two versions: The Basic Version 
and the Advanced Version. The major capabilities of each of these 
versions are: 


ae Basic Version GEMCOS: 


1) Transaction Control Language. 
2) Access control. 

3) Message routing. 

4) Message auditing. 

5) Network control. 

6) Message restoration. 
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7) Nonwparticipating MCS. 
be. Advanced Version GEMCQS: 


1) Alt Baste Version pape hees 
2) Message formatting. 


Nore information about GEMCOS capabilities is provided in the remainder 
of this manuat. Section 3 describes Basic Version GEMCOSs sections 3 
and 4 describe Advanced Version GEMCOS. 
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Figure 271.2 GEMCOS/DMS [I Relationship 


SECTION 3 


BASIC VERSION GEMCOS 


The fotlowing major capabilities of Basic Version GEMCOS are discussed 
in this section: fJTransaction Control Lanaquayer» access controls» message 
routings message auditing» network control» and message restoration. 
Other assorted features provided in the Basic Version are also 
discussed. 


TRANSACTION CONTROL LANGUAGE CTCL). 

The various environments under which an MCS could operate dictated that 
a simple method for describing requirements unique to a user's specific 
eavironment be developed. Both the requirements and the environment 
are expectea to be dynamic. GEMCOS adapts to differing needs by 
permitting a user to describe his requirements in TCL. 


In att GEMCLS versions» FCL is used to describe criteria ranging from 
message7routing criteria» and access~control requirements to message 
formats and a variety of other GEMCOS options. 


The language has a free-form structures using key words to describe both 
the environment and the requirements of the data communications user. 
The result of a TCL compilation is a set of customized tables. (The 

TCL compiler optionally provides a hard~copy record of the data commu- 
nications system description.) The MCS code which interprets those 
tables is modular in structure. The GEMCOS design is totatly compatible 
with the virtualc*memory concept. 


The TCL exauaple shown in figure 3-1 is a complete description of a very 
Simple system consisting of two stations and one program. 


ACCESS _ CONTROL. 

Access control is optionally available on a station-by-station basis. 
If it is declared to be in effect for a given stations the legitimate 
users of that station can be specified. A valid sign-on procedure at 
the station must be followed to gain access to the system. Specific 
Limitations on types of transactions entered or programs used by any 
user signing on may also be specified. Thus» using the standard access 
control feacures» GEMCOS may be instructed to allow access to a spe- 
cific List of transactions and/or programs on a usersby-user basis. 
Moreover» each user is restricted to a specific set of stations. An 
example foliows. 


Suppose “ABC123" is one of several access keys employed in a system. 
Persons assigned A&SC123 are to be restricted to the use of onty station 
STA7. They are to be further restricted to the use of only message 
keys UPD ang INQ. To implement these restrictionse the following two 
statements would appear in the access control section and station 
section of the TCL deck» respectively: 


ACCESSCONTROL = | 
ACCESSKEY ABCi23 = UPD» INQ. 
STATION STA?C7): 
VALIDUSERS = ABC123. 


COMMENTS 


CONTROL = LIST, CAUSES TCL REPORT TO BE PRINTED. 
GENERATE. CAUSES NEW TABLES AND MCS SOURCE 
CODE TO BE GENERATED. 
GLOBAL: 
CONTROL STATIONS = TTY1. % TTY11S PERMITTED TO ENTER NETWORK 
CONTROL COMMANDS. 


BEGIN 
PROGRAM PRGM1 USER: PRGM1 1S CLASSIFIED AS A USER 


PROGRAM CAPABLE OF PROCESSING 4 
DIFFERENT TRANCODES. 
TITLE = SAMPLE/USER/PGM. SPECIFIES NAME OF CODE FILE. 
TRANCODE = KEY 1. TRANSACTION CODES WHICH WILL 
TRANCODE = KEY2. CAUSE MESSAGES TO BE ROUTED TO 
TRANCODE = INQUIRE. PRGM1. 
TRANCODE= UPDATE. 
STATION TTY1: THE MCS WILL CONTROL STATIONS 
STATION TD801: TTY1 AND TD801. 
END. 


Figure 3-1. TCL Description of 7 
Data Communications Network 


MESSAGE ROUSING. 
Several types of message routing are provided by the Basic Version of 
GEMCOS. Messages can be routed from: 


ae Station to application program. 
be. Application program to station. 
Ce Station to station. 


When a destination station is out of services an alternate station may 
be specifieu by using a network control command. 


The three methods available to allow messages to be routed from stations 
to programs are: 


ae A program may attach itself to a set of stations (a remote 
fite) and messages entered at those stations will be routed. 
to the attaching program. 


b. A station may attach itself to a program and messages entered 
at the attaching station will be routed to the program. 


ce. Transaction codes may be associated with programs so that when 
a wessage containing a particular transaction code is entered 
at a stations the message is routed to the program defined to 
process that transaction. 


User programs can address output to specific stations on a sStation-by- 
station basise- If a user program takes no action to specificaliy route 
aresponsee the message is routed to the sender of the input message. 


By using a network control command» users at Stations can route 
messages to other stations (Cor the supervisory console). 


MESSAGE AUDATING. 

The GEMCOS tasic Version will» if requested» create an audit file of 
messages as they pass through the MCS.~ ALl messages which are entered 
from stations and are bound for application programs (i.@. messages 
which could be applied to a data pase) can be audited. In additions 
all messages bound for stations may be audited. The message auditing 
function is used by the message restoration function to aid programs 
during data base recovery. 


NETWORK CONJROL. 

In order to dynamically control the data communications processing 
environment» the user may designate a particular station as a network 
control station. A network control station is priviledged in that it 
may enter commands which may reconfigure and/or manage the network. 
For example» a network control station may make stations ready» make 
stations not readyr change a station maximum retry counts change a 
Station alternate stations» change a station address» start and stop 
programs» bring down the systems» etc. GEMCOS notifies the network 
control station of various exception conditions as they occur. The 
supervisory console may act as a network controi station. 


Network control also attlows stations in the network to make various 
inquiries to GEMCOS» route messages to other stations» attach them- 
selves to programs» etc. 


The Network Control function accumulates changes made to stations in 
the network in a disk file. If GEMCOS is halted and then re-executed>» 
GEMCOS automatically reconfigures the network back to its last running 
state regaruless of the fact that the network controller may have 
forgotten which changes had occurred. 


MESSAGE RESTORATION. 

In coordination with the message auditing capability» message 
restoration can aid application programs during data base recovery. 

The Message Restoration function allows any application program to spe- 
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specify the last message it has processed. GEMCOS wilt send all messages 
which were sent to the program after the last known message to have 

been processed by the program. If a data base has been rolted back 
during a recovery process» the application programs can request to be 
sent atl messages which occurred after a particutar checkpoint. 


A_NON-PARTICIPALING MCS. | 

In certain special instances» an applications environment may not 
require the routing options available in GEMCOS,» but rather a simple 
straightforward way to move text between stations and programs. To 
accommodate such applications» the GEMCOS system also yives the user 
the option of creating a non-participating system in which the MCS 
performs the single function of handling network controls sign-on and 
communications errors» and teaves all message routing to the Master 
Control Program (NCP). 


ADDIITLONAL FEATURES. 
The following additional features are also provided in the GEMCQS 
Basic Version: 


ae A variety of statistical information concerning stations» 
programs» and GEMCOS is available to the user in a realtime 
mode» This data can help the user fine tune the systea 
foilowing initial implementation. 


be GEMCOS detects» diagnoses» and recovers from a variety of 
data communications error situations. 


ce Fixed data relating to a particular transaction type may be 
automatically passed to application programs by GEMCOS» based 
upon TCL specifications. 


d»- <A Screen Wraparound function is availabie in GEMCOS. The 
function causes output messages which would be too large 
for the buffer of the destination station to be automatically 
segmented and sent in several transmissions. 


ee. Programs may be designated as core or disk resident to atlow 
the user to help the system make more effective use of memory. 


f. GEawCOS can run in a simulation mode without a network control- 
ler in the mix. 


ge Network control commands may be entered via a card reader. 


he. GEmMCOS is not restricted to any particular set of stations. 
It can work with any or all of the stations defined in the 
network controller. 


ie GEMCOS contains an optional monitor trace feature. The 
monitor trace is a very useful debugging aid which creates 
a Listing on a line printer displaying messages as they pass 
through the MCS» their sources destinations and the procedures 
of the MCS which were invoked to process thea. 


3-4 


User written UPL procedures can be merged into GEMCOS to 
supplement and/or replace standard GENCOS functions. 


GEMCOS is capable of interfacing application programs written 
in COBOL» FORTRAN» RPG» and UPL. 


SECTION 4& 


ADVANCED VERSION GEMCOS 


In addition to all the Basic Version capabilities» Advanced Version 
capabilities include message formatting.j Message formattingse untque 
to the Advanced Versions is discussed in this section. 


MESSAGE FORMATTING. 


Formatting of messages 1s independent of user programs. A user writing 
an application program is not required to know hardware control codes 
or buffer capacity for tne various terminals in the network. Rather»e 
the application programmer can deal with the data strings at the point 
of program interface. <A user independently describes» in ICL» a format 
descriptions used by GEMCOS to format those data strings. 


GEMCOS retrieves format descriptions» based upon both message identi- 
fication key and the device class of the station involvedse and applies 
the format to the data-e- This allows tremendous flexibility at the 
Stations» transparent to the application programmer. For examples the 
application program can tell GEMCOS to send an identical message to 
two stations in the network. If those two stations are in different 
device classes» the output messages may be formatted using two differ- 
ent format cescripttions provided in ICL» resulting in drastically 
different outputs delivered to the stations. Such data-field charac- 
teristics as length» sequencer and related form information can vary 
from station to station for an output message destined for multiple 
Stations. Conversely,» two different stations can supply input for the 
Same type of transaction under different formats» and the data will 
arrive at the application program ina standard format. Such activity 
is transparent to the application program. 


Some of the other capabilities of GEMCOS formatting include: 
ae Forms retrieval. 


be Format modification without compilation of application 
programs. | 


Ce Numeric field verification. 


d- Handling of variable Length fields» with zero/space fill 
ana right/left justification. | 


ee. Data translation. 


The example in figure 4°1 shows how a message which appears fixed in 
format to a user program may look quite different at each of several 
Stations which may send or receive the message. It is emphasized that 
this example applies equally well to input (message sent from program 
to station). A different format would be used for each of the three 
screensSe 


SCREEN 1: 


MSG KEY [TC10] 


NAME [JOHN DOE], 


SSN [484603151] 


DATE OF BIRTH [09/04/48] 


SCREEN 2: 


MSG KEY [TC10] 


GEMCOS USER 
FORMATTER ) PROGRAM 


| NAME [DOE, JOHN] 


SSN [484-60-3151] 


BIRTH DATE [SEPT 4, 1948] 
MESSAGE AS IT APPEARS TO PROGRAM 


TCIOJOHN DOE 484603151090448 . 


ee a ; aii od 
MSG BIRTH 
KEY NAME SSN DATE 


SCREEN 3: 


MSG KEY [TC10] 


NAME [DOE, JOHN] 


BIRTH [48 SEPT 4] 


SSN [484603151] 


Figure 4-1. Rearrangement of 
Output Fieids 
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